Bug 606378 - gdk doesn't handle non-main thread rendering on Quartz
authorJohn Ralls <jralls@ceridwen.us>
Fri, 3 May 2013 23:41:49 +0000 (16:41 -0700)
committerJohn Ralls <jralls@ceridwen.us>
Fri, 3 May 2013 23:45:03 +0000 (16:45 -0700)
Document that the restrictions on Win32 apply also to Quartz.

gdk/gdk.c

index 01a4b7a0b3b71d6ef716683bf7389fd04620dfa2..f1fa0d7461f0474315c20e88d8a021a08c71a7a6 100644 (file)
--- a/gdk/gdk.c
+++ b/gdk/gdk.c
@@ -666,12 +666,12 @@ gdk_init (int *argc, char ***argv)
  * </informalexample>
  *
  * Unfortunately, all of the above documentation holds with the X11
- * backend only. With the Win32 backend, GDK and GTK+ calls should not
- * be attempted from multiple threads at all. Combining the GDK lock
- * with other locks such as the Python global interpreter lock can be
- * complicated.
+ * backend only. With the Win32 or Quartz backends, GDK and GTK+ calls
+ * must occur only in the main thread (see below). When using Python,
+ * even on X11 combining the GDK lock with other locks such as the
+ * Python global interpreter lock can be complicated.
  *
- * For these reason, the threading support has been deprecated in
+ * For these reasons, the threading support has been deprecated in
  * GTK+ 3.6. Instead of calling GTK+ directly from multiple threads,
  * it is recommended to use g_idle_add(), g_main_context_invoke()
  * and similar functions to make these calls from the main thread